eslint-scope

What is eslint-scope?

The eslint-scope npm package is used to analyze the scope of variables within JavaScript code. It is part of the ESLint family of tools and is used to determine where variables are declared and how they are used throughout the code. This can be particularly useful for identifying issues with variable shadowing, undeclared variables, or potential scope leaks.

What are eslint-scope's main functionalities?

Analyzing variable scope in a JavaScript file

This code sample demonstrates how to use eslint-scope to analyze the scope of variables in a JavaScript file. It reads the file, parses it into an AST (Abstract Syntax Tree) using espree, and then analyzes the scope with eslint-scope. The resulting globalScope object contains information about the variables and references in the global scope of the file.

const eslintScope = require('eslint-scope');
const espree = require('espree');
const fs = require('fs');

const code = fs.readFileSync('myfile.js', 'utf8');
const ast = espree.parse(code, { ecmaVersion: 6 });
const scopeManager = eslintScope.analyze(ast);

const globalScope = scopeManager.globalScope;
// Inspect the variables and references in the global scope
console.log(globalScope.variables);
console.log(globalScope.references);

Other packages similar to eslint-scope

escope

Escope is another scope analysis tool for JavaScript. It is similar to eslint-scope but is no longer actively maintained. Escope was the predecessor to eslint-scope and served a similar purpose in analyzing variable scope within JavaScript code.

jscodeshift

Jscodeshift is a toolkit for running codemods over multiple JavaScript or TypeScript files. It uses a different approach but can be used for similar scope analysis and transformation tasks. Jscodeshift provides a more extensive API for manipulating the AST and is often used for large-scale codebase refactors.

babel-traverse

Babel-traverse allows you to traverse and manipulate the AST generated by Babel. While its primary use is for Babel plugins and transformations, it can also be used to analyze scope and variable declarations in a manner similar to eslint-scope. Babel-traverse is part of the larger Babel ecosystem, which is widely used for JavaScript compilation and transformation.

README

ESLint Scope

ESLint Scope is the ECMAScript scope analyzer used in ESLint. It is a fork of escope.

Install

npm i eslint-scope --save

📖 Usage

To use in an ESM file:

import * as eslintScope from 'eslint-scope';

To use in a CommonJS file:

const eslintScope = require('eslint-scope');

Example:

import * as eslintScope from 'eslint-scope';
import * as espree from 'espree';
import estraverse from 'estraverse';

const ast = espree.parse(code, { range: true });
const scopeManager = eslintScope.analyze(ast);

const currentScope = scopeManager.acquire(ast);   // global scope

estraverse.traverse(ast, {
    enter (node, parent) {
        // do stuff

        if (/Function/.test(node.type)) {
            currentScope = scopeManager.acquire(node);  // get current function scope
        }
    },
    leave(node, parent) {
        if (/Function/.test(node.type)) {
            currentScope = currentScope.upper;  // set to parent scope
        }

        // do stuff
    }
});

Contributing

Issues and pull requests will be triaged and responded to as quickly as possible. We operate under the ESLint Contributor Guidelines, so please be sure to read them before contributing. If you're not sure where to dig in, check out the issues.

Build Commands

• npm test - run all linting and tests
• npm run lint - run all linting

License

ESLint Scope is licensed under a permissive BSD 2-clause license.